home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / maple / fixes < prev    next >
Encoding:
Text File  |  1994-06-21  |  5.9 KB  |  168 lines
  1.  
  2. The lib subdirectory under the share directory for each version of Maple
  3. contains fixes and other updates to the Maple library, for example
  4. simple bug fixes, efficiency improvements, and corrections to help files.
  5. Note, we do not provide fixes for every bug in Maple in this way because
  6. some fixes require changes to the Maple kernel, and others require
  7. global changes to many files.
  8.  
  9. This message contains three parts
  10. A: Installing Fixes/Updates
  11. B: Testing (how to test if the fixes/updates are installed correctly)
  12. C: Where is the Maple library?
  13.  
  14. If all this fails, call me, FAX me, or e-mail me at
  15.  
  16. TEL: +41 1 632-7473 (Till
  17. FAX: +41 1 262-3963
  18. E-MAIL: monagan@inf.ethz.ch
  19.  
  20. Michael Monagan
  21.  
  22.  
  23. Installing Fixes/Updates
  24. ========================
  25.  
  26. Fixes/updates are placed under the lib directory in the share library.
  27. For each fix/update, you will find two files, a so called Maple ".m" file,
  28. and the Maple src file.
  29. To install the fixes/updates, you have several possibilities, depending
  30. on which version of Maple you have and which kind of computer you have.
  31. From easiest to hardest, they are
  32.  
  33. 1: (for Maple V Release 2 only)
  34.    In the directory 5.2/lib in the share library, you will find two files
  35.    maple.ind and maple.lib.  The file maple.lib is a Maple library archive
  36.    of all the fixes, and the file maple.ind is an index into the file
  37.    maple.lib for fast access.
  38.    Make a new directory <fixlib> on your system, copy these files into
  39.    this directory, start Maple, and specify
  40.  
  41.        libname := <fixlib>, libname;
  42.  
  43.    This causes Maple to search the <fixlib> directory before it searches
  44.    the Maple library.
  45.  
  46.    For single users, you can put this command in your .mapleinit file so
  47.    that it is executed automatically everytime you start Maple.
  48.  
  49.    For Unix system administrators who want to install fixes for all users,
  50.    you should update the maple script in the maple bin directory as follows.
  51.    Immediately after the text
  52.  
  53.    # Start the Motif version of Maple if -x was specified. Otherwise start
  54.    # the TTY version (which might in turn start the Motif interface). Iris
  55.    # parameters are not allowed if the TTY version is started.
  56.  
  57.    before Maple is started, insert the following commands
  58.  
  59.    FIXLIB=...the directory where you put the fixes...
  60.    KPARAM="$KPARAM -b $FIXLIB,$MAPLE/lib"
  61.  
  62. 2: (for Unix systems only)
  63.    The file lib.tar.Z is a compressed Unix tar file of all the ".m" files
  64.    under the directory lib.  After copying this file you can unpack it by
  65.    executing the commands
  66.  
  67.        uncompress lib.tar
  68.        tar xf lib.tar
  69.  
  70.    This will create a subdirectory called "lib" under the current directory
  71.    if none already exists.  If such a directory already exists, files
  72.    underneath it will be overwritten.
  73.  
  74.    a) The easiest way to install the fixes if you have write access to your
  75.       copy of the Maple library, is to overwrite the Maple library directory.
  76.       Just cd to the directory which contains the Maple library and execute
  77.       the above commands.
  78.  
  79.    b) If you do not have write access to the Maple library, install the fixes
  80.       under your home directory.  If you have Maple V Release 2, you can now
  81.       access the fixes as in option (1).  If you have Release 1, you need to
  82.       use the "uselib" command from the Maple share library.
  83.    
  84. 3: Copy the Maple .m file(s) to the corresponding place in your Maple library.
  85.    For example, if the file is int/discont.m, you need to put the file
  86.    discont.m in the int subdirectory in the Maple library.  If the
  87.    subdirectory does not exist, you need to create it.
  88.  
  89.    If you do not have write permissions, make your own image of the Maple
  90.    library in the directory <fixdir> and put the .m file in the corresponding
  91.    place in this directory.  Now, go to step 2 b.
  92.  
  93. 4: Copy the Maple src file(s) and load it, i.e. execute the command
  94.  
  95.         maple -s < file
  96.  
  97.    (The syntax of the command is slightly different on non-Unix systems)
  98.    Maple will read in the src code and try to save it in your copy of the
  99.    Maple library.  The actual place where it is saved is given in the save
  100.    statement in the src code.  For example
  101.  
  102.        save polar, ``.libname.`/polar.m`;
  103.  
  104.    saves the polar routine into the file polar.m in the Maple library.
  105.    If you do not have write permissions on your copy of the Maple library,
  106.    Maple will reply with the following error
  107.  
  108.        Error, could not open polar.m for writing
  109.  
  110.    In this case, change the save statement to save the file into the
  111.    current directory by doing
  112.  
  113.        save polar, `polar.m`;
  114.  
  115.    Now go to step 3.
  116.  
  117.  
  118. Testing
  119. =======
  120.  
  121. To check that you installed the fixes/updates correctly:
  122.  
  123. For Maple V Release 1 execute the following test
  124.  
  125.    > factor(14406+343*N2**2+N2**4);
  126.    Error, (in factor/try1) modp1: invalid arguments to function Multiply 
  127.  
  128. If the fix is installed correctly, you should get instead of the error
  129. the factorization
  130.  
  131.                                 2          2
  132.                              (N2  + 49) (N2  + 294)
  133.  
  134. For Maple V Release 2 execute the following test
  135.  
  136.    > expand(Psi(1,x+2));
  137.  
  138.                                              1
  139.                             Psi(1, x) - -----------
  140.                                          2        2
  141.                                         x  (x + 1)
  142.  
  143. If the fix is installed correctly, you should get instead
  144.  
  145.  
  146.                                         1        1
  147.                           Psi(1, x) - ---- - --------
  148.                                         2           2
  149.                                        x     (x + 1)
  150.  
  151.  
  152. Where is the Maple library?
  153. ===========================
  154.  
  155. You can find out where the Maple library is kept by going into Maple and typing
  156.  
  157.        > libname;
  158.  
  159. The libname variable is a global variable whose value is a string which
  160. specifies the directory where the Maple library is.
  161. On a Unix system, you will get something like this
  162.  
  163.                      /home/rutishauser/oed4/maple/lib
  164.  
  165. On a PC, you will get something like this
  166.  
  167.                      C:/maple/lib
  168.